home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / mouse tools / pointerx / pointerx.doc < prev    next >
Text File  |  1996-04-07  |  11KB  |  288 lines
  1.  
  2.                    .oO°Oo.
  3.                    ¯¯¯¯¯¯¯
  4.                 PointerX 3.05
  5.                    _______
  6.                    °Oo.oO°
  7.  
  8.  
  9.         © 1994 Dave Jones aka Te®m¿natø® / Ðe$t¿ny.
  10.  
  11.  
  12. Contents:
  13. ~~~~~~~~~
  14.  1.  Archive contents.
  15.  2.  Distribution.
  16.  3.  What does it do and why ?
  17.  4.  Requirements.
  18.  5.  Usage.
  19.  6.  Bugs.
  20.  7.  Technical Information.
  21.  8.  History.
  22.  9.  Future?
  23.  10. About the author.
  24.  11. Contact Address.
  25.  12. Thanks.
  26.  
  27.  
  28. 1. Archive contents.
  29. ~~~~~~~~~~~~~~~~~~~~
  30. The archive you recieved `PointerX_305.Lha' should contain the following
  31. files (Plus possibly some BBS adverts)
  32.  
  33.     PointerX    ................... This is the executable.
  34.     PointerX.doc    ................... This File!
  35.     PointerX.Guide    ................... This, in Amigaguide (TM) format.
  36.  
  37. And no other files.
  38. PointerX needs no libraries/devices e.t.c., it is a stand-alone program.
  39.  
  40.  
  41. 2. Distribution.
  42. ~~~~~~~~~~~~~~~~
  43. PointerX is a giftware program, i.e. if you like/use it, then send me a
  44. gift of some sort.. any kind of miscellaneous rubbish ;-)
  45. Just brighten my day, by letting me know that someone uses PointerX
  46. In return, (Depending on how busy my life is at the time) I may even
  47. write to you occasionally, sending you updates/other programs e.t.c...
  48.  
  49. Permission is granted for you to spread this archive across all electronic
  50. storage mediums BBS,InterNet e.t.c... as long as the files are not modified
  51. in any way whatsoever.
  52.  
  53. Permission is also granted for this program to be included in any PD CD
  54. collections (As long as you send me a copy guys.. what you say huh? ;-)
  55.  
  56. It also cool for magazines to put this on their coverdisks.
  57.  
  58.  
  59. 3. What does it do and why ?
  60. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  61. A few months ago, I bought a copy of `Amiga User International', which
  62. had a program called PointerX 2.0 on the coverdisk.
  63. Cool!, This program makes the hands on the busy pointer spin!
  64. But, after loading the program on my 1200, it refused to animate the busy
  65. pointer!
  66.  
  67. So, I threw the disk back into the diskbox, and continued with everyday life.
  68. That was, until an hour ago, when I was soooo bored whilst waiting for a
  69. program to assemble, that I thought, `shame PointerX don't work, it'd look
  70. real neat right now...'
  71.  
  72. I then decided to disassemble the PointerX program, and make it work on all
  73. machines.
  74.  
  75. A while later, and PointerX 3 was born.
  76.  
  77.  
  78. 4. Requirements.
  79. ~~~~~~~~~~~~~~~~
  80. To run PointerX you need...
  81.  ° Workbench 2 or above. (Yup, now even WB3 is okay!)
  82.  ° Something that sets the busy `clock' icon
  83.     (To test it, Load a workbench, select `execute program' and click
  84.      back in the workbench screen ;^)
  85.  
  86. No other requirements whatsoever.
  87.  
  88.  
  89. 5.Usage.
  90. ~~~~~~~~
  91. To run PointerX, simply type PointerX in the CLI, or doubleclick it from
  92. workbench. (Anyone wanna draw me an icon?)
  93.  
  94. To abort, you can send the program a Ctrl-C signal (With Xoper,ARTM e.t.c..)
  95. and the program will restore everything and exit gracefully.
  96.  
  97. PointerX can now also be removed by simply running it again.
  98.  
  99.  
  100. 6.Bugs!
  101. ~~~~~~~
  102. ° Not really, a bug, but something I have to workaround sometime..
  103.  
  104.   1) Boot a disk without running PointerX
  105.   2) Do something which will set a busy pointer (A file requestor is a
  106.      good method - Click outside the filerequestor window.)
  107.   3) Whilst it's still the busy pointer, load PointerX.
  108.   4) Note how it doesn't spin. If you cancel the requestor, and then
  109.      select it again, they will spin. ;-)
  110.   5) Also, if you remove PointerX while a busy pointer is spinning, the
  111.      hands will stay at that position until you cancel the requestor ;-)
  112.   This isn't really a problem, and doesn't rank too highly on my `to do' list
  113.  
  114.  
  115. 7. Technical Information.
  116. ~~~~~~~~~~~~~~~~~~~~~~~~~
  117. ° Coded in 100% Assembly Language for speed and size. (or lack of size!)
  118.   The Source code length is 897 lines including Pointer sprites as Dc.w's
  119. ° Code is 100% PC relative, which means it will load at any address without
  120.   any need for relocation. Let's see `C' coders write a program like that!
  121. ° Utilises fast memory if available. [ regardless of location ]
  122. ° The code will free any allocated memory / libraries and exit gracefully
  123.   on failure / exit.
  124. ° Autodetatches from CLI (No need to `RUN PointerX')
  125. ° Each version of PointerX has been tested extensively with Enforcer, and
  126.   returns no hits. [ Unless my serial lead is broken again ;^( See V3.04! ]
  127. ° Each version of PointerX has had extensive testing by myself and my
  128.   ever faithful army of ßeta-testers who will (hopefully) be sure to let me
  129.   know if there are any problems ;-)
  130. ° Some people have suggested that I shouldn't take credit for PointerX 3,
  131.   but I would like to point out, that very little of Steve Tibbetts
  132.   PointerX 2 remains in my version.
  133.   The only unchanged remnants, are the pointer graphic data.
  134.   EVERYTHING has been recoded, not from scratch, but still, it looks a darn
  135.   sight different from Steve's version.
  136.   Incidentally Steve, if you're interested in the source code for this, then
  137.   drop me a line (With some kind of proof that you are THE Steve Tibbett
  138.   - The original source for PointerX 2 would probably be proof enough..)
  139. ° PointerX has been developed on an A1200HD with 68030 MMU/FPU and 2mb
  140.   of lovely 32 bit fastram. (Yummy.)
  141.  
  142.  
  143. 8.History.
  144. ~~~~~~~~~~
  145.  1.0        No information.
  146.  
  147.  2.0        First version I owned.
  148.          ° Only works on kickstart 2.04
  149.          ° Written by Steve Tibbett.
  150.  
  151.  3.0   28.9.94    Released only to ßeta testers
  152.          ° I (Dave Jones) took over.
  153.         ° Some obvious optimizations were made.
  154.         ° Now works on WB3, as I now patch the
  155.           Intuition/SetWindowPointerA() function as well as the
  156.           Intuition/SetPointer() function.
  157.         ° Added auto-detatch code, no more need to `RUN PointerX'.
  158.  
  159.  3.01  23.10.94    First Full Public Release - Appeared on the coverdisk
  160.         of Amiga User International.
  161.          ° Fixed NewSetWindowPointer().
  162.            It no longer causes Enforcer hits.
  163.         ° If you now run PointerX twice, it'll Uninstall itself.
  164.         ° Uses FastMem if available.
  165.         ° Improved auto-detatch code.
  166.         ° Various small optimizations.
  167.  
  168.  3.02 27.10.94    Not publically released. Released only to Beta testers
  169.         ° More PC relativity added.
  170.         ° Some obscure optimizations added.
  171.  
  172.  3.03 7.11.94    Not released : personal test version
  173.         ° Code is now 100% PC Relative.
  174.          ° Code has had loads of optimizations made, both for speed
  175.            and size, and is now as small and fast as possible. (IMHO)
  176.         ° Fixed a harmless bug in the auto-detatch code.
  177.         ° Removed some redundant code.
  178.         ° Finally removed some spelling mistakes in this doc!
  179.           previous versions stated I was 21, Hmm.. too much Vodka..
  180.           (or maybe not enough ;-)
  181.  
  182.  3.04 8.11.94     Second public release.
  183.         ° Removed an enforcer hit that's been there since ?????
  184.           My serial lead was broken, so my terminal wasn't getting
  185.           the enforcer hit messages! Sorry!
  186.         ° Some more small optimizations, removal of duplicate code.
  187.         ° Now uses minimal amount of CPU time even when in the
  188.           `busy' state. - Virtually nil when not `busy'.
  189.         ° Corrected several mistakes in the docs, which referenced
  190.           MoveVBR (One of my other programs) that's what you get
  191.           for being lazy, and modifying another doc. ;-)
  192.  
  193.  3.05 26.12.94     Third public release - Uploaded to InterNET in a last-ditch
  194.         attempt to get some fame! Send me mail! Just to let me know
  195.         that people are using PointerX 3 !
  196.         ° Uses an optimized SegSplit routine, which saves 4 bytes
  197.           Yippee. (!)
  198.         ° Now includes a rather nice icon.
  199.         ° More spell checking done on docs ;-Þ
  200.  
  201. 9. Future.
  202. ~~~~~~~~~~
  203. ° Fixing of any bug reports. (None I hope ;-)
  204. ° Maybe have a parameter to adjust the speed at which the hands spin ?
  205. ° Any suggestions ?
  206.  
  207.  
  208. 10. About the Author.
  209. ~~~~~~~~~~~~~~~~~~~~~
  210. I'm a 20 year old male (born 6th Feb 1974 - Birthday presents welcome ;-)
  211. I work 9-5 as a data entry clerk with a finance firm, which is sooooooo
  212. boring ;-(  I've been a commercial programmer for a while, which may seem
  213. like the ideal job, but when your getting a regular wage for your coding,
  214. it seems to take away all the fun.
  215. Now, I code just for fun which is much more rewarding, but pays less. ;-)
  216. (Anyone wanna send me some bribes ?)
  217.  
  218.  
  219. 11. Contact Address.
  220. ~~~~~~~~~~~~~~~~~~~~
  221. Feel free to contact me for donations, presnts, flames, bug-reports, ideas,
  222. requests, or even just to say hello..
  223. also feel free to contact me if you have a program you'd like to see
  224. fixed/improved for WB2/3
  225.  
  226.  Dave Jones.
  227.  40,Heol Edward Lewis,
  228.  Gelligaer,
  229.  Hengoed,
  230.  Mid Glamorgan,
  231.  Cf8 8ej,
  232.  South Wales,
  233.  U.k.
  234.  
  235. Including postage guarantees 1 day turnaround.
  236.  
  237. You can also send me E-Mail at Narc/Destiny's address.
  238.  
  239.             spe3kdr@cardiff.ac.uk
  240.  
  241. *NB - Coz this isn't MY net address, chances are you could be waiting a week
  242. or so for a reply, you'll get a faster reply (probably) by snail-mail ;-)
  243. - Kinda ironic huh ?
  244.  
  245.  
  246. 12. Thanx/ Greetz e.t.c...
  247. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  248.  
  249.     Massive Appreciation to the following exalted members
  250.             of the human race:
  251.  
  252. ° Commodore for the machine.
  253. ° Motorola for 680x0  Intel Outside!
  254. ° HiSoft for Devpac 3.04
  255. ° Golden Wonder for Pot Noodles.
  256. ° Pink Floyd, MegaDeth for musical support during development.
  257. ° Whoever invented headfones (For late night development ;-)
  258. ° Narc / Destiny for the loan of his 1200HD for a short while ;-)
  259.   I really should buy my own.. Donations please readers... ahem..
  260. ° Morten Erikson for PicCon 2.32ß - Where the hell are you?
  261. ° Klaus Deppisch for Diskspare.device v3 which is great.
  262. ° Chris Green & Dave Haynie, Ex-CBM for writing cool software.
  263. ° Michael Sinz for Enforcer.
  264.  
  265.  
  266.     Specially huge amounts of hatred and Buckets of cess
  267.     ridden filth to the poor downtroden victims that follow:
  268.  
  269. ° The security guards at Cardiff University for not letting me in for
  270.   free InterNET access any more ;-( B**t*rds!
  271. ° Mehdi Ali for Screwing Commodore into the state it's in now.
  272. ° Motorola for not sending me the MMU books I asked for... Hmph.. ;-(
  273.   (Anyone got any MMU docs ?)
  274. ° HiSoft for Devpac 3.15 which is totally screwed on my setup.
  275.   Fancy blaming the Ram-Speed of my lovely Viper30.. Shame on you.
  276. ° Michiel Pelt - For not including any disk salvage utilities with PFS
  277.   PLEASE! Someone write a disksalv for this otherwise amazing program.
  278.   (Must » I « write everything ? ;^)
  279.   BTW: PFS9 has some real bad bugs in it... Truncating files etc...
  280. ° Future Publishing for the lamest computer show ever.
  281.   FES 94 Was so small, how could you justify such an extortionatly large
  282.   entrance fee? If any of your staff use LibMon, please donate a £7
  283. ° To everyone who uses my other utilities, but is too tight to even send
  284.   me a postcard... Darn you...
  285.   That means YOU! user of PointerX, MoveVBR, SquashText, LibMon,
  286.   HunkMaster e.t.c.
  287.   Maybe I'll start crippling my shareware.. Hmm. Is this what it takes ?
  288.